Road Map to QuickTime 4
The movie toolbox provides the functions that most applications will use to create, edit, and play QuickTime movies. This chapter describes the methods your application will use to initialize QuickTime, and to open and play movies, and the primary functions used to create and convert movies. The topics in this chapter are of interest to most developers working with QuickTime.
Determining Whether the Movie Toolbox Is InstalledInside Macintosh describes how to use the Gestalt Manager to identify the version of QuickTime that is installed. Nearly all applications will use this function.
Getting Ready to Work With MoviesInside Macintosh describes the steps your application must take before it can work with QuickTime movies. Nearly all applications will use these steps.
Initializing the Movie ToolboxInside Macintosh describes the functions every application must use to establish a working QuickTime environment.
Getting a Movie From a Mac OS FileInside Macintosh shows how to load a movie from a Macintosh HFS or HFS+ disk file, using the OpenMovieFile and NewMovieFromFile functions. Windows programmers will need to perform an additional step, described below.
Getting a Movie From a Windows FileQuickTime for Windows Programmers shows how to convert the data returned from a standard Windows file dialog into a format that can be used with NewMovieFromFile. Windows programmers should read this section.
Loading a MovieQuickTime 4 Reference shows how to load a movie that does not reside in a movie file. Read this if your application will be loading movies from other sources, such as a data handler for an external device.
Determining Movie Creation and Modification TimeInside Macintosh describes the functions used to read the creation date and most recent modification date for movies, tracks and media.
Inside Macintosh describes the functions used to create, access, and convert movie files. QuickTime 4 Reference describes functions that are new or have changed since the publication of Inside Macintosh.. The functions listed below as "Original" are defined in Inside Macintosh.. The functions listed as "New" are defined in QuickTime 4 Reference. The functions listed under "Changes" are defined in Inside Macintosh, but have enhancements that are documented in the QuickTime 4 Reference.
Changes (click to see changes; for original definition, look under Original):
Inside Macintosh shows how you can use a movie controller component to simplify playing a movie. Read this section if your application will play movies, and you are considering using a QuickTime movie controller. Sample code is included.
Playing a MovieInside Macintosh describes how to play a movie using low level Movie Toolbox functions. Read this section if your application will play movies without using the Movie Controller. Sample code is included.
Controlling Movie PlaybackInside Macintosh describes the basic functions your application will use to play movies. This information is of interest to all developers.
Managing the Video Frame Playback RateQuickTime 4 Reference describes two functions you can use to determine the playback rate for each video frame. These functions are useful for debugging.
Using the Full ScreenQuickTime 4 Reference describes two functions you can use to display movies using the full screen.
Using Movies in Your Event LoopInside Macintosh briefly discusses how to grant time to the Movie Toolbox to allow your movies to play. A short code sample is included. Read this section to see how to structure the event loop in your program so that QuickTime movies can be displayed. QuickTime for Windows Programmers includes code samples showing an event loop under the Windows operating system.
Movies and Your Event LoopInside Macintosh describes the functions your application must call inside your event loop to allow movies to display. Also documented are functions for redrawing a movie that has been uncovered, determining if a movie is done, detecting whether a point lies in a movie or a particular track, and functions for testing the status of movies and tracks. QuickTime 4 Reference adds a new function to this list. This information will be needed by all developers.
Working With Sound VolumeInside Macintosh describes the functions used to set and read the audio volume level for a movie or track.
Preferred Movie SettingsInside Macintosh describes the functions your application can use to read and set a movie's default playback rate and audio volume. Most applications will use these functions.
Enhancing Movie Playback PerformanceInside Macintosh describes functions that can be used to improve playback performance, typically by preprocessing or loading some portion of the movie into RAM before playback. QuickTime 4 Reference adds new functions to this list. You should refer to the definitions of these functions if you need higher performance during movie playback.
Obsolete (no longer supported):
Disabling Movies and TracksInside Macintosh describes the functions your application will use to enable and disable movies. Only enabled movies will be serviced by the MoviesTask.
Movies and the ScrapInside Macintosh briefly discusses how your application can place movies onto the system scrap and retrieve movies from the scrap, using the PutMovieOnScrap and NewMovieFromScrap functions.
The Movie Toolbox and System 6Inside Macintosh discusses using the Movie Toolbox on Macintosh computers that are running System 6. This will be of interest only to programmers with a need to provide backward compatiblity with older Macintosh computers.
Error FunctionsInside Macintosh describes the functions your application will use to examine result codes generated by Toolbox functions.
Result CodesInside Macintosh lists the common error codes returned by Movie Toolbox functions.